home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 4 / Night Owl's Shareware - PDSI-004-1 - Wayzata Technology (1990).iso / 029a / imp346.lzh / IMP-346.LZH / SYSOP.DOC < prev   
Text File  |  1990-12-09  |  52KB  |  1,317 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                 - - - IMPERIUM - - -
  13.  
  14.  
  15.                            THE WARGAME OF THE MILLENNIA
  16.  
  17.  
  18.                              Multi-Player Version 3.46
  19.  
  20.  
  21.                 A door game designed to run under PCBoard v12 & 14
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                   9 December 1990
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.           Copyright (C) 1988, 1989, 1990, Search IV.  All rights Reserved
  59.  
  60.  
  61.  
  62.   Imperium v3.46           9 December 1990              Sysop Documentation  ______________                                        ___________________
  63.  
  64.  
  65.  
  66.   Registration
  67.  
  68.  
  69.     The software in this package is a demonstration version of Imperium. The
  70.   game is completely functional but it will only allow games to run for four
  71.   weeks. No time bombs, warning sirens, or deleted files, any games over 30
  72.   days old will simply cease to cycle. If the game works well on your BBS and
  73.   your callers enjoy playing Imperium, then please register it. Any games that
  74.   were held up by the registration timeout can be resumed by placing the key
  75.   file in the directory that the game is running from.
  76.  
  77.     Registration is only $20 and it gets you the current version of Imperium;
  78.   support and assistance (beyond basic installation help) is an additional
  79.   $10/yr and gives you access to all updates and beta-codes as they become
  80.   available, as well as access to the Imperium Support Conference on the Castle
  81.   of the Four Winds BBS.
  82.  
  83.     If this sounds like a great deal to you, please fill out the attached order
  84.   form (Appendix D) and make your check or money order (in US Funds only,
  85.   please) payable to:
  86.  
  87.                    Christopher King
  88.                    2215-1 Dublin Lane
  89.                    Diamond Bar, Ca  91765
  90.  
  91.     It generally takes us about 8-10 days to process an order and get a disk
  92.   out in the US Mail (Unless otherwise requested all disks mailed out will be
  93.   360k 5¼" media). You can, however, download your Imperium key file from the
  94.   Castle of the Four Winds. We recommend that you call when you mail the
  95.   registration and let us know to post your key file. Your key file will then
  96.   be made available as soon as we receive the registration fee. If you have a
  97.   FIDO or RBBS Net address, please notify us of it and if you have no
  98.   objections we'll file-send the key file to you directly.
  99.  
  100.  
  101.   Disclaimer
  102.  
  103.     IMPERIUM is distributed in an as-is condition. There are no warranties
  104.   either expressed or implied. By setting up and running IMPERIUM, you are
  105.   acknowledging that any damage that may occur by the operation of this program
  106.   (physical or monetary) does not make Christopher King, The Castle of the Four
  107.   Winds, or Search IV liable for anything more than replacing the Imperium
  108.   software.
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.                                       - 2 -
  123.  
  124.  
  125.  
  126.   Imperium v3.46           9 December 1990              Sysop Documentation  ______________                                        ___________________
  127.  
  128.  
  129.   Installation
  130.  
  131.  
  132.     De-arc the IMPERIUM archive into the sub-directory that you plan to have
  133.   the game run out of; the program does not require any special naming
  134.   conventions with regard to drive or path names. The most basic setup for
  135.   the game simply involves typing IMPINIT, from the DOS prompt. This will
  136.   cause all data/map/communication/result files associated with previous
  137.   games to be deleted and a new map and data files will be generated.  When
  138.   this process has completed (3-5 minutes) the game will be ready to run.
  139.  
  140.  
  141.     ImpInit requires the file CITYNAME.DAT in order function properly and
  142.   will create the following files:
  143.  
  144.        Imperium.Sys - Imperium configuration and system data  [binary]
  145.        ImpCity.Dat  - Imperium City data                      [binary]
  146.        ImpPlay.Dat  - Imperium Player data                    [binary]
  147.        ImpMap.000   - Imperium master map file                [binary]
  148.        City.Out     - List of cities created                   [text]
  149.        Map.Out      - Text file version of Map file.           [text]
  150.  
  151.     The Sysop has several ways of controlling the way the setup and play of
  152.   the game; the Imperium configuration file can be altered to affect the
  153.   characteristics of the units, the vulnerability of cities and forces, and
  154.   the reports that are generated; the type of map that is created by the
  155.   program can be controlled via command line parameters to ImpInit; and
  156.   custom maps can be created and used. Each of these ways is discussed in
  157.   greater detail in the following sections.
  158.  
  159.     The most basic way for the Sysop to control the setup of the game, is by
  160.   altering the Imperium configuration file (IMPERIUM.CFG). The format of this
  161.   file is given in Appendix A. It is a ascii text file that can be edited
  162.   with any simple line editor, by changing the values in this file the Sysop
  163.   can control the probability of successful attacks against enemy units,
  164.   enemy cities, and uncontrolled cities; the score file format and content
  165.   can be specified; the cost, movement, strength, hardness, and range of all
  166.   the unit types in the game can be controlled; the cruise missile warhead
  167.   types and power can also be specified. New with the 3.3+ releases the sysop
  168.   can also specify each player's starting forces. It is recommended that
  169.   players only start with ships in custom game setups, there are no guarantees
  170.   that all players will start out with ports in a random map.
  171.  
  172.     In this release the ImpInit program has been completely redone, adding
  173.   three new command line parameters, Rivers, MaxRad, and MinRad.  A substantial
  174.   speed increase is also present.  An error checking routine has been added if
  175.   the program is unable to place the player cities, aborting the run after
  176.   three tries.  Since the initial player cities must be placed at least 20
  177.   units distance from each other (on a random setup), and some maps will not
  178.   allow for such placement.  A MAP.OUT file however will always be written,
  179.   therefore you can edit map.out adding cities and run it through again using
  180.   the /F parameter.  Starting Player cities in Graphics mode are now displayed
  181.   in white for easier map checking.
  182.  
  183.  
  184.  
  185.  
  186.                                       - 3 -
  187.  
  188.  
  189.  
  190.   Imperium v3.46           9 December 1990              Sysop Documentation  ______________                                        ___________________
  191.  
  192.        ImpInit Command Line Options:
  193.  
  194.           /G   -   Graphics on.
  195.                    ImpInit will display the map as it is created.
  196.                    Very useful for examining the playability of a
  197.                    map. EGA & VGA systems only. [Default Off]
  198.  
  199.           /L   -   Land masses.
  200.                    Determines the number of land masses that
  201.                    ImpInit will create. Values less than 15 will
  202.                    produce maps that consist of a large ocean with
  203.                    islands. Values greater than 30 will create maps
  204.                    with large continents and several potentially
  205.                    separate seas and lakes. Values less than 10 may
  206.                    not initialize properly and are not recommended.
  207.                    [Default 20]
  208.  
  209.           /R   -   Rivers
  210.                    Determines the number of river branches that
  211.                    will be created.  Rivers are started only on
  212.                    land and continue towards a large water mass
  213.                    or the edge of the world whereupon they stop.
  214.                    If a river intersects another river already
  215.                    in place it stops forming an upstream branch.
  216.                    There is a slight chance of a river looping
  217.                    and connecting itself.  Suggested parameter
  218.                    size 20.
  219.                    [Default 0]
  220.  
  221.  
  222.           /M   -   Mountains.
  223.                    Determines the number of mountain ranges that
  224.                    will be created. Mountains are created only on
  225.                    land, and there is no checking to make certain
  226.                    that cities are not locked in. The value for
  227.                    this option should be about equal to the Land
  228.                    mass value (i.e. if /L20 is specified, /M20
  229.                    is recommended.
  230.                    [Default 0]
  231.  
  232.           /S  -    Swamps.
  233.                    Determines the number of swamps and marshes that
  234.                    will be created. Swamps are created only on land
  235.                    and only near water or rivers. The value for
  236.                    this option can be fairly high (up to double the
  237.                    land value) but not too high or ImpInit may have
  238.                    difficulty placing the cities on the map.
  239.                    [Default 0]
  240.  
  241.           /X   -   Change Maximum Land mass radius.
  242.                    This parameter allows you to change the maximum size
  243.                    of each individual land mass created.  Values
  244.                    over 50 equal 50, and values less than minimum
  245.                    radius = minimum radius.
  246.                    [Default 20]
  247.  
  248.  
  249.  
  250.                                       - 4 -
  251.  
  252.  
  253.  
  254.   Imperium v3.46           9 December 1990              Sysop Documentation  ______________                                        ___________________
  255.  
  256.           /Y   -   Change Minimum Land mass radius.
  257.                    This parameter allows you to change the minimum size
  258.                    of each individual land mass created. Values
  259.                    less than 3 equal 3 and values greater than maximum
  260.                    radius = maximum radius.
  261.                    [Default 5]
  262.  
  263.           /F   -   External Map.
  264.                    Determines whether or not the game map should be
  265.                    created by ImpInit or read in from an external
  266.                    file. The format of the input file is discussed
  267.                    in the next section. The form of the option is
  268.                    /F<file name>. (i.e. /FInput.Map).
  269.                    [Default None]
  270.  
  271.   Samples:
  272.  
  273.            Impinit /G /L20 /R20 /M20 /S20
  274.                   Fairly standard land campaign may or may not have
  275.                   a continuous ocean.
  276.  
  277.            Impinit /G /L60 /R20 /M20 /S25 /X7 /Y3
  278.                   A definite Island campaign.
  279.  
  280.  
  281.   External Map Files
  282.  
  283.     The sysop also has the power to create custom maps for IMPERIUM. The map
  284.   file must be 100 characters wide by 100 lines long; the characters that can
  285.   be used in the making the map are:
  286.  
  287.                  [.]  -  Water
  288.                  [+]  -  Land
  289.                  [^]  -  Mountains
  290.                  [≈]  -  Swamps
  291.  
  292.     In this current version of IMPERIUM, the Sysop can choose to place all,
  293.   some, or none of the cities in the map file. It is important to note
  294.   however that if any cities are specified, the first fifteen cities MUST be
  295.   specified using the characters '1'..'0' and 'A' through 'E'. Any other
  296.   cities can be placed using any of the following [*,O,o,X,x].
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.                                       - 5 -
  315.  
  316.  
  317.  
  318.   Imperium v3.46           9 December 1990              Sysop Documentation  ______________                                        ___________________
  319.  
  320.   Running Imperium
  321.  
  322.     Included in the IMPERIUM archive is an example batch file for bringing up
  323.   IMPERIUM under PCBoard. There are several requirements for running
  324.   IMPERIUM:
  325.              [*]  A PC-AT or clone. The door could probably be run
  326.                   from an XT if the clock speed was turbo'd to at least
  327.                   10 Mhz. Anything slower than 10 Mhz and your callers
  328.                   are going to die of boredom during the screen updates.
  329.  
  330.              [*]  640k of memory...for a full 15 player setup. The number
  331.                   of players that can participate in the game is a direct
  332.                   function of the amount of available machine memory. At
  333.                   this time Imperium does not support EMS.
  334.  
  335.              [*]  500k - 1.5M of disk space. This factor depends on a number
  336.                   of things; such as the number of players and how 'inter-
  337.                   active' they are. IMPERIUM makes no checks for disk
  338.                   space.
  339.  
  340.   This would also seem to be the appropriate place to mention that Imperium
  341.   handles ComPort I/O in one of two manners; either through the use of internal
  342.   asynchronous communications routines or through calls to a fossil
  343.   communications driver. As of this release there is only one integrated
  344.   version of Imperium; it will detect the presence of a fossil driver and
  345.   utilize it if found, otherwise it will revert back to it's internal i/o
  346.   code. The internal I/O routines should be fine for most BBS's that run at
  347.   baud rates of 9600 or less. If your system runs at a higher speed or utilizes
  348.   locked baud rates to improve your users' data throughput then you need to use
  349.   an external fossil driver along with Imperium (Imperium has been successfully
  350.   tested with X00, BNU, and OpusComm).
  351.  
  352.  
  353.      Getting back to the more pressing matters at hand, running IMPERIUM.
  354.   IMPERIUM takes two command line parameters. The first is the path to the
  355.   PCBOARD.SYS file and the second is the version of PCBoard that is being
  356.   used.
  357.  
  358.   For example:
  359.  
  360.      C> IMPERIUM D:\PCB14\ 14   <-- Get PCBoard.Sys version 14 from D:\PCB14\
  361.  
  362.    IMPERIUM can be run in local mode, by entering:
  363.  
  364.      C> IMPERIUM LOCAL
  365.  
  366.    The program will then prompt the user for his/her name.
  367.  
  368.  
  369.    The following is a copy of the batch file that we at the Castle of the
  370.   Four Winds use to run IMPERIUM:
  371.  
  372.           c:
  373.           cd \doors\Imperium
  374.           Imperium D:\Pcb14\ 14
  375.           d:
  376.           cd \pcb14
  377.           board
  378.                                       - 6 -
  379.  
  380.  
  381.  
  382.   Imperium v3.46           9 December 1990              Sysop Documentation  ______________                                        ___________________
  383.  
  384.  
  385.   Midnight Event
  386.  
  387.     IMPERIUM must be cycled every night, in order for movement counters to be
  388.   reset, new units constructed, revolts enacted, bulletins generated, etc.
  389.   The program that does this is called IMPCYCLE. No command line parameters
  390.   are necessary. If the configuration file specifies that bulletins are to be
  391.   generated then the files IMPRIUM.RPT and IMPRIUMG.RPT will be created. The
  392.   following is an example of what to include in the EVENT.SYS file.
  393.  
  394.  
  395.         CD \Doors\Imperium
  396.         ImpCycle
  397.         Copy Imprium.Rpt D:\PCB14\Games\GBLT8
  398.         Copy ImpriumG.Rpt D:\PCB14\Games\BLT8G
  399.  
  400.  
  401.  
  402.   Sysop Functions
  403.  
  404.  
  405.     Function    Activating Key     Description
  406.  
  407.     Snoop          F-key 8         Pressing this key toggles the Sysop
  408.                                    Snoop on & off. When the   snoop
  409.                                    is off, a screen displaying who is
  410.                                    playing  and how long they've been on is
  411.                                    shown.
  412.  
  413.     Eject          F-key 9         Pressing this key immediately causes
  414.                                    Imperium to shut down, save off all
  415.                                    player files and return the user to
  416.                                    the BBS.
  417.  
  418.     Chat           F-key 10        Pressing F10 causes Imperium to enter
  419.                                    a full screen sysop chat mode. The sysop
  420.                                    and user can type back and forth inter-
  421.                                    actively. The screen does not scroll but
  422.                                    rather returns to the top after the screen
  423.                                    fills. To exit chat mode, press the ESC
  424.                                    key, this causes Imperium to restore the
  425.                                    users screen (monochromatically), and re-
  426.                                    turn to whatever it was performing.
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.                                       - 7 -
  443.  
  444.  
  445.  
  446.   Imperium v3.46           9 December 1990              Sysop Documentation  ______________                                        ___________________
  447.  
  448.  
  449.   Sysop Utilities
  450.  
  451.     Distributed with the Imperium door program is a sysop utility program
  452.   called, ImpUtil. This program is a much reworked and rewritten
  453.   version of the original ImpUtil; there are still some functions that need
  454.   implementation but for the most part the program is complete. The user
  455.   interface has been redone into a pulldown menu format (sorry, no mouse
  456.   support as yet). Anyway, just about all the game data and parameters are
  457.   modifiable through this program.
  458.  
  459.     The menu for ImpUtil looks like the following:
  460.  
  461.             System       Players       Cities       Units      Maps
  462.             ~~~~~~       ~~~~~~~       ~~~~~~       ~~~~~      ~~~~
  463.  
  464.  
  465.   ImpUtil Functions
  466.  
  467.   1.  System  - All the game level system parameters are modifiable through
  468.                 this function; the submenu looks like:
  469.                    +------------+
  470.                    |Bulletin    |
  471.                    |Info        |
  472.                    |MaxPlayers  |
  473.                    |pK Values   |
  474.                    |Strat Forces|
  475.                    +------------+
  476.  
  477.                 ... Bulletin brings up another submenu that allows all of
  478.                     the bulletin functions to be altered.
  479.                 ... Info displays all the basic system level game parameters:
  480.                     Current day; Number of Players; Number of free cities,
  481.                     etc.
  482.                 ... MaxPlayers allows the maximum number of players allowed in
  483.                     the game to be altered.
  484.                 ... pK Values allows editing of the probability of kill
  485.                     values.
  486.                 ... Strat Forces allows the sysop to define the four warhead
  487.                     types that will be used by cruise missiles in the game.
  488.                     The parameters that are edited are:
  489.                         a) Radius of effect. Fairly obvious, this value
  490.                            specified how much territory a warhead will damage.
  491.                            This region is 'rounded' on the map, rather than
  492.                            square.
  493.                         b) Damage class. This value is the specifies the
  494.                            'type' of warhead. There are eight classes (0..7)
  495.                            which are explicitly defined in appendix B. The
  496.                            damage gets worse from 0 (conventional) to 7
  497.                            (dirty fusion).
  498.                         c) Probability of dissipation/expansion. Only
  499.                            applicable for chemical and biological warheads.
  500.                            Chemical effects will dissipate over time.
  501.                            Biological effects will spread. This parameter
  502.                            governs how quickly.
  503.  
  504.  
  505.  
  506.                                       - 8 -
  507.  
  508.  
  509.  
  510.   Imperium v3.46                9 December 1990         Sysop Documentation  ______________                                        ___________________
  511.  
  512.  
  513.   2.  Players - Use the arrow keys to select the empire to edit. The page
  514.                 up/down keys will also move you through each Empire after
  515.                 you have made the initial selection; the home/end keys will
  516.                 go to the first and last empires. Pressing the [E] key will
  517.                 put the program into edit mode. The Empire Name field will
  518.                 be highlighted initially; use the up/down arrows to move
  519.                 between this field and the Player Name. Press Enter to change
  520.                 the names. To edit the units press the [Tab] key after
  521.                 entering edit mode, use the up & down arrows to select the
  522.                 unit to edit and press [E] again to change characteristics of
  523.                 the unit or press [A] to add a new unit to the players forces.
  524.  
  525.   3.  Cities  - The city editor submenu looks like the following:
  526.                    +----------+
  527.                    |Empire    |
  528.                    |Goto      |
  529.                    |Name      |
  530.                    |Production|
  531.                    +----------+
  532.  
  533.                  ... Empire allows the sysop to selectively edit only the
  534.                      cities of a given Empire.
  535.  
  536.                  ... Goto a specific city (number) and start editing from
  537.                      there.
  538.  
  539.                  ... Name will ask and search for a specified city name.
  540.  
  541.                  ... Production allows the sysop to selectively edit only the
  542.                      cities that are producing the specified unit.
  543.  
  544.   4.  Units   - All of the general cost and movement values for each unit
  545.                 class are editable through this function. Use the tab and
  546.                 shift tab to move from field to field. Press Enter to change
  547.                 the data.
  548.  
  549.   5.  Maps    - This menu combines the old map view function with the long
  550.                 awaited and almost fully functional map editor!
  551.  
  552.                    +------+
  553.                    | View | >>-----> +------------+
  554.                    | Edit |          | Master     |
  555.                    +------+          | Empire     |
  556.                                      | Production |
  557.                                      | Forces     |
  558.                                      +------------+
  559.  
  560.                 ... The view function brings up a really sharp high-res
  561.                     graphics view (EGA/VGA) of the map type selected. All the
  562.                     functions display the master map, with the lower three
  563.                     overlaying a view of either the empire's map, what the
  564.                     cities are producing, or the forces currently out there.
  565.  
  566.                 ... The edit function brings up a full screen map editor that
  567.                     works very much like the normal Imperium edit function.
  568.                     All the terrain is editable, but the cities are fixed.
  569.  
  570.                                       - 9 -
  571.  
  572.  
  573.  
  574.   Imperium v3.46                9 December 1990         Sysop Documentation  ______________                                        ___________________
  575.  
  576.  
  577.   Known Bugs & Anomalies
  578.  
  579.   [*]  There is no validation done on the map other than checking to make
  580.        certain that the first fifteen cities are spaced over 20 units away
  581.        from each other. This means that it is possible for islands to be
  582.        created without ports, and mountain ranges to lock cities in. The
  583.        sysop should validate the game map either via the ImpInit /G option
  584.        or by examining the output file produced by ImpInit, MAP.OUT. This
  585.        file can be edited and fed back into ImpInit using the /F option.
  586.  
  587.   [*]  Submerged subs become temporarily visible during results when
  588.        neighboring a unit that sees someone else approach.
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.                                      - 10 -
  635.  
  636.  
  637.  
  638.   Imperium v3.46                9 December 1990         Sysop Documentation  ______________                                        ___________________
  639.  
  640.  
  641.   Credits
  642.  
  643.     The IMPERIUM program was written in Turbo Pascal 5.5 by Christopher King
  644.   under the auspices of Search IV. The program has been alpha & beta tested
  645.   on the Castle of the Four Winds BBS in Diamond Bar, Ca and all requests for
  646.   support and registration of this program should be directed to:
  647.  
  648.                             Search IV
  649.                             attn: Christopher King
  650.                             2215-1 Dublin Lane
  651.                             Diamond Bar, Ca 91765
  652.  
  653.                         or electronic mail can be left on
  654.  
  655.                             Castle of the Four Winds
  656.                                  (714) 860-3213
  657.  
  658.                                RBBS Net 8:911/202
  659.                                FIDO Net 1:103/315
  660.  
  661.                              or on CompuServe to ID:
  662.                                    74017, 1665
  663.  
  664.               Expect a 1-2 week delay on Compuserve Communications.
  665.                   The online costs have driven us down to about
  666.                        two to three times online a month.
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.                                      - 11 -
  699.  
  700.  
  701.  
  702.   Imperium v3.46                9 December 1990         Sysop Documentation  ______________                                        ___________________
  703.  
  704.  
  705.   Closing Kudos
  706.  
  707.      Many thanks to the following people:
  708.  
  709.   Carl Evans, Sysop of the Warboard, for his feedback and tolerance of a
  710.   novice door writer.
  711.  
  712.   Frank Koenig, for giving me the push to actually write the program.
  713.  
  714.   Jim Beveridge, for giving me a lot of valuable feedback and background
  715.   info on the original game of Empire.
  716.  
  717.   Kevin Porter, for writing the fossil interface and supplying suggestions
  718.   and improvements for higher performance machines. And for providing me with
  719.   a lot of help in tracking down the vicious memory mites and range worms.
  720.  
  721.   Tom Hazel, for allowing me to use his sorting algorithm to greatly improve
  722.   the speed of the unit sorts.
  723.  
  724.   Mike Bandoian, for putting all the time and effort into making ImpInit work
  725.   like it has Warp-drive; making the gas & bio secondary effects work as
  726.   advertised... and then adding even more features (including docs).
  727.  
  728.   Michael Williams for a lot of invaluable help with improving the code logic
  729.   to improve the execution speed and keep down the executable size.
  730.  
  731.   Rob Teoh, Wayne Shaw, Shelby & Tracy Noonan, and Gary Bush for all the
  732.   suggestions on ways to improve the game, the user interface, and just
  733.   about everything else.
  734.  
  735.   The residents of the Castle of the Four Winds for their extreme
  736.   tolerance during the alpha & beta testing of the door; for putting
  737.   up with all those unfinished games.
  738.  
  739.   And most especially, extreme thanks are due to Sheila King for all
  740.   the help, support, and Mountain Dew that it took to put this all
  741.   together.
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.                                      - 12 -
  763.  
  764.  
  765.  
  766.   Imperium v3.46                9 December 1990         Sysop Documentation  ______________                                        ___________________
  767.  
  768.  
  769.   Appendix A
  770.  
  771.   Imperium Configuration File
  772.  
  773.     The sysop has the power to alter the IMPERIUM configuration file,
  774.   Imperium.Cfg. This file controls a large number of key factors to the
  775.   game, including:
  776.  
  777.   [*] Maximum number of players. How many people can
  778.   participate in the game at any given time. Defaults to 15,
  779.   but for sysops with more memory constrained systems the
  780.   number of players can be set lower.
  781.  
  782.   [*] Bulletin report generation. How much information is displayed
  783.   by the report, how it is to be ranked, and whether or not a
  784.   color report is to be generated.
  785.  
  786.   [*] Probability of Kill (pK) values. What percent chance of
  787.   failure does an army have when attacking an unowned city, an
  788.   enemy city, or do units have when attacking enemy units.
  789.  
  790.   [*] How far can each type of unit can move in one day. How many
  791.   days does it take to build each type of unit. How much damage
  792.   can each unit take, and how much damage it can give.
  793.  
  794.     The configuration file is a sequential ascii text file that can be
  795.   modified with any standard text editor. The format of the file is of
  796.   critical importance. It is recommended that any changes be made to a
  797.   copy of the file that comes with the IMPERIUM archive. In the event
  798.   that this file is not in the archive or that is somehow was damaged or
  799.   destroyed. The IMPERIUM.CFG file format is as follows.
  800.  
  801.     Lines  1- 5 : Header information, non-critical.
  802.  
  803.     Line   6    : Maximum number of players allowed in the game
  804.     Line   7    : Initial number of cities on the map
  805.     Line   8    : Sysop Snoop Default
  806.  
  807.     Line   9    : blank delimiter line
  808.  
  809.     Lines 10-16 : Bulletin generator controls
  810.     Line  10    : Bulletin On (1) / Off (0)
  811.     Line  11    : Bulletin Ranking by Cities (1) by Forces (2) by Score (3)
  812.     Line  12    : Display users name:    Yes (1) / No (0)
  813.     Line  13    : Display total cities : Yes (1) / No (0)
  814.     Line  14    : Display total forces : Specific (2) / General (1) / No (0)
  815.     Line  15    : Display score        : Yes (1) / No (0)
  816.     Line  16    : Generate color report: Yes (1) / No (0)
  817.  
  818.     Lines 17-19 : pK information
  819.     Line  17    : percent chance of failure of an attack on an enemy city
  820.     Line  18    : percent chance of failure of an attack on a free city
  821.     Line  19    : percent chance of failure of a force on force attack
  822.  
  823.     Line  20    : blank delimiter line
  824.  
  825.  
  826.                                      - 13 -
  827.  
  828.  
  829.  
  830.   Imperium v3.46                9 December 1990         Sysop Documentation  ______________                                        ___________________
  831.  
  832.  
  833.     Lines 21-32 : Number of each type of unit that players start with
  834.     Line  21    : Starting number of Armies
  835.     Line  22    : Starting number of Fighters
  836.     Line  23    : Starting number of Tanks
  837.     Line  24    : Starting number of Destroyers        **Use with Caution**
  838.     Line  25    : Starting number of Submarines        **Use with Caution**
  839.     Line  26    : Starting number of Troop Transports  **Use with Caution**
  840.     Line  27    : Starting number of Cruisers          **Use with Caution**
  841.     Line  28    : Starting number of Aircraft Carriers **Use with Caution**
  842.     Line  29    : Starting number of Battleships       **Use with Caution**
  843.     Line  30    : Starting number of Cruise Missiles
  844.     Line  31    : Starting number of Engineers
  845.     Line  32    : Starting number of Dredges
  846.  
  847.     Line  33    : blank delimiter line
  848.  
  849.     Lines 34-38 : Unit Configuration: Army
  850.     Line  34    : Max moves per day
  851.     Line  35    : Max hits per army
  852.     Line  36    : Number of Armies (and days) it takes to build a city.
  853.     Line  37    : Construction cost (in days)
  854.     Line  38    : Amount of damage an army does per hit.
  855.  
  856.     Line  39    : blank delimiter line
  857.  
  858.     Lines 40-44 : Unit Configuration: Fighter
  859.     Line  40    : Max moves per day
  860.     Line  41    : Max hits per Fighter
  861.     Line  42    : Max Range
  862.     Line  43    : Construction cost (in days)
  863.     Line  44    : Amount of damage a fighter does per hit.
  864.  
  865.     Line  45    : blank delimiter line
  866.  
  867.     Lines 46-50 : Unit Configuration: Tank
  868.     Line  46    : Max moves per day
  869.     Line  47    : Max hits per Tank
  870.     Line  48    : 0
  871.     Line  49    : Construction cost (in days)
  872.     Line  50    : Amount of damage a tank does per hit.
  873.  
  874.     Line  51    : blank delimiter line
  875.  
  876.     Lines 52-56 : Unit Configuration: Destroyer
  877.     Line  52    : Max moves per day
  878.     Line  53    : Max hits per Destroyer
  879.     Line  54    : 0
  880.     Line  55    : Construction cost (in days)
  881.     Line  56    : Amount of damage a Destroyer does per hit.
  882.  
  883.     Line  57    : blank delimiter line
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.                                      - 14 -
  891.  
  892.  
  893.  
  894.   Imperium v3.46                9 December 1990         Sysop Documentation  ______________                                        ___________________
  895.  
  896.  
  897.     Lines 58-62 : Unit Configuration: Submarine
  898.     Line  58    : Max moves per day
  899.     Line  59    : Max hits per Sub
  900.     Line  60    : 0
  901.     Line  61    : Construction cost (in days)
  902.     Line  62    : Amount of damage a Submarine does per hit.
  903.  
  904.     Line  63    : blank delimiter line
  905.  
  906.     Lines 64-68 : Unit Configuration: Troop Transport
  907.     Line  64    : Max moves per day
  908.     Line  65    : Max hits per Transport
  909.     Line  66    : Maximum number of armies that can be carried
  910.     Line  67    : Construction cost (in days)
  911.     Line  68    : Amount of damage a Transport does per hit.
  912.  
  913.     Line  69    : blank delimiter line
  914.  
  915.     Lines 70-74 : Unit Configuration: Cruiser
  916.     Line  70    : Max moves per day
  917.     Line  71    : Max hits per Cruiser
  918.     Line  72    : 0
  919.     Line  73    : Construction cost (in days)
  920.     Line  74    : Amount of damage a Cruiser does per hit.
  921.  
  922.     Line  75    : blank delimiter line
  923.  
  924.     Lines 76-80 : Unit Configuration: Aircraft Carrier
  925.     Line  76    : Max moves per day
  926.     Line  77    : Max hits per Carrier
  927.     Line  78    : Maximum aircraft that can be carried
  928.     Line  79    : Construction cost (in days)
  929.     Line  80    : Amount of damage a Carrier does per hit.
  930.  
  931.     Line  81    : blank delimiter line
  932.  
  933.     Lines 82-86 : Unit Configuration: Battleship
  934.     Line  82    : Max moves per day
  935.     Line  83    : Max hits per Battleship
  936.     Line  84    : Maximum aircraft that can be carried
  937.     Line  85    : Construction cost (in days)
  938.     Line  86    : Amount of damage a Battleship does per hit.
  939.  
  940.     Line  87    : blank delimiter line
  941.  
  942.     Lines 88-92 : Unit Configuration: Cruise Missile
  943.     Line  88    : Max moves per day
  944.     Line  89    : Max hits per Missile
  945.     Line  90    : Max flight range without refueling
  946.     Line  91    : Construction cost (in days)
  947.     Line  92    : Amount of damage a conventional warhead does
  948.  
  949.     Line  93    : blank delimiter line
  950.  
  951.  
  952.  
  953.  
  954.                                      - 15 -
  955.  
  956.  
  957.  
  958.   Imperium v3.46                9 December 1990         Sysop Documentation  ______________                                        ___________________
  959.  
  960.  
  961.     Lines 94-98 : Unit Configuration: Engineer
  962.     Line  94    : Max moves per day
  963.     Line  95    : Max hits per Engineer
  964.     Line  96    : Number of days it takes to carve a pass/ford.
  965.     Line  97    : Construction cost (in days)
  966.     Line  98    : Amount of damage a Engineer does per hit.
  967.  
  968.     Line  99    : blank delimiter line
  969.  
  970.     Lines100-104: Unit Configuration: Dredge
  971.     Line 100    : Max moves per day
  972.     Line 101    : Max hits per Dredge
  973.     Line 102    : Number of days it takes to cut a channel
  974.     Line 103    : Construction cost (in days)
  975.     Line 104    : Amount of damage a Dredge does per hit.
  976.  
  977.     Line 105    : blank delimiter line
  978.  
  979.     Lines106-108: Class I Warhead Configuration
  980.     Line 106    : Radius of Effect
  981.     Line 107    : Type of warhead
  982.     Line 108    : Expansion/Dissipation Rate
  983.  
  984.     Line 109    : blank delimiter line
  985.  
  986.     Lines110-112: Class II Warhead Configuration
  987.     Line 110    : Radius of Effect
  988.     Line 111    : Type of warhead
  989.     Line 112    : Expansion/Dissipation Rate
  990.  
  991.     Line 113    : blank delimiter line
  992.  
  993.     Lines114-116: Class III Warhead Configuration
  994.     Line 114    : Radius of Effect
  995.     Line 115    : Type of warhead
  996.     Line 116    : Expansion/Dissipation Rate
  997.  
  998.     Line 117    : blank delimiter line
  999.  
  1000.     Lines118-120: Class IV Warhead Configuration
  1001.     Line 118    : Radius of Effect
  1002.     Line 119    : Type of warhead
  1003.     Line 120    : Expansion/Dissipation Rate
  1004.  
  1005.     Line 121    : blank delimiter line
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.                                      - 16 -
  1019.  
  1020.  
  1021.  
  1022.   Imperium v3.46                9 December 1990         Sysop Documentation  ______________                                        ___________________
  1023.  
  1024.  
  1025.  
  1026.   Appendix B
  1027.  
  1028.   Warhead Types:
  1029.  
  1030.      Damage Class   Type            Description
  1031.      ~~~~~~~~~~~~   ~~~~            ~~~~~~~~~~~
  1032.            0        Conventional    Cities and terrain are unaffected, units
  1033.                                     are damaged/destroyed according to the
  1034.                                     strength of the cruise missile unit.
  1035.                                     Only units at the impact location are
  1036.                                     affected
  1037.  
  1038.            1        Neutron Bomb    Cities revert to unowned. Terrain is un-
  1039.                                     changed. All units within the radius are
  1040.                                     destroyed.
  1041.  
  1042.            2        Nerve Gas       Cities revert to unowned. Terrain is
  1043.                                     contaminated. All units in area are
  1044.                                     killed. Units entering the area are
  1045.                                     damaged.
  1046.  
  1047.            3        Simple Bio      Cities revert to unowned. Terrain is
  1048.                                     contaminated. All units in area die.
  1049.                                     Units entering the area are damaged,
  1050.                                     units that leave the area spread the
  1051.                                     contamination.
  1052.  
  1053.            4        Clean Fusion    Cities are destroyed. Territory remains
  1054.                                     unchanged. All units in area annihi-
  1055.                                     lated.
  1056.  
  1057.            5        Toxic Waste     Cities are destroyed. Territory is more
  1058.                                     heavily contaminated. Units in area are
  1059.                                     destroyed. Units entering area are
  1060.                                     damaged.
  1061.  
  1062.            6        Complex Bio     Cities are destroyed. Territory is con-
  1063.                                     taminated. All units in area die. Units
  1064.                                     entering the area are damaged, units
  1065.                                     that leave the area spread the
  1066.                                     contamination.
  1067.  
  1068.            7        Dirty Fission   Cities are destroyed. Territory is laid
  1069.                                     to waste. All units in area die. Units
  1070.                                     entering area die. The effects are perm-
  1071.                                     anent.
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.                                      - 17 -
  1083.   Appendix B (continued)
  1084.  
  1085.  
  1086.      How to Set the Expansion/Dissipation Rates
  1087.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1088.  
  1089.        For the gas & bio warhead classes another field in the configuration
  1090.      file comes into play, the Expansion/Dissipation rate. This value which
  1091.      can range from 0 to 100 will control how quickly gas clouds will dissipate
  1092.      and how quickly plagues will spread. Generally, a value of 0 will cause
  1093.      the secondary effects to clear up by the next day, while a value of 100
  1094.      would cause the effects to either not dissipate at all or expand very
  1095.      rapidly. The following list will give a feel for how various rates will
  1096.      work:
  1097.  
  1098.      Rate                  Gas Warhead                   Bio Warhead
  1099.      ~~~~                  ~~~~~~~~~~~                   ~~~~~~~~~~~
  1100.        0                   Dissipates completely         Dissipates completely
  1101.                            by next day.                  within two days.
  1102.  
  1103.       25                   Dissipates at about 2         Dissipates at about 1
  1104.                            radii units per day.          radius unit per day.
  1105.  
  1106.       50                   Dissipates at about 1         Doesn't dissipate or
  1107.                            radius unit per day.          grow at all.
  1108.  
  1109.       75                   Dissipates at about 1         Grows at about 1
  1110.                            radius unit per 2 days.       radius unit per 2 days
  1111.  
  1112.      100                   Doesn't dissipate at          Grows at about 1
  1113.                            all.                          radius unit per day.
  1114.  
  1115.  
  1116.   Appendix C
  1117.  
  1118.   Error Log File (and what the numbers mean):
  1119.  
  1120.      Error No.    Error
  1121.      ~~~~~~~~~    ~~~~~
  1122.        1 -  99    Turbo Pascal DOS Error. Please report error & address.
  1123.      100 - 149    Turbo Pascal I/O Error. Please report error & address.
  1124.      150 - 199    Turbo Pascal Critical Error. Please report...
  1125.      200 - 255    Turbo Pascal Fatal Error. Please report...
  1126.  
  1127.      500 - 599    Miscellaneous Imperium errors.
  1128.                     500 - Lost City
  1129.                     501 - No name in PCBoard.Sys
  1130.                     502 - Unrecognized PCBoard version
  1131.                     503 - Problem with build city routine
  1132.  
  1133.      700 - 799    Imperium Communication Errors/Aborts
  1134.                     700 - No carrier           750 - No carrier (fossil)
  1135.                     701 - Unable to open port  751 - Unable to init (fossil)
  1136.                     702 - Invalid port no.     752 - Invalid port # (fossil)
  1137.                     703 - Invalid baud rate    753 - Invalid baud  (fossil)
  1138.                     704 - Invalid parity       754 - Invalid parity (fossil)
  1139.  
  1140.      800 - 899    Imperium File Errors
  1141.                     800 - No Key file          850 - No Extern map (init)
  1142.                     801 - No Sys file          851 - Insuff cities on map
  1143.                     802 - No Player file             (init)
  1144.                     803 - No Master map
  1145.                     804 - No PCBoard.Sys file
  1146.                     825 - No Player file (cycle)
  1147.  
  1148.      900 - 999    Imperium General Aborts
  1149.                     999 - Leave without entering game
  1150.                     998 - Game full
  1151.                     997 - Sysop eject
  1152.                     996 - KB timeout
  1153.                     995 - Max Time exceeded
  1154.                     994 - Player suicide
  1155.                     993 - Illegally modified key file
  1156.  
  1157.   Appendix D
  1158.  
  1159.                                Imperium Order Form                               ___________________
  1160.  
  1161.  
  1162.   Name:_____________________________________________________________________       ____________________________________________________________________
  1163.  
  1164.   Mailing Address
  1165.   Street        :___________________________________________________________                 ___________________________________________________________
  1166.  
  1167.   City          :___________________________________________________________                 __________________________________________________________
  1168.  
  1169.   State/Zip Code:___________________________________________________________                 __________________________________________________________
  1170.  
  1171.   Country       :___________________________________________________________                 __________________________________________________________
  1172.  
  1173.   Voice Number (optional):__________________________________________________                          _________________________________________________
  1174.  
  1175.  
  1176.   BBS Name:_________________________________________________________________           _________________________________________________________________
  1177.  
  1178.   BBS Number (optional):____________________________________________________                        ____________________________________________________
  1179.  
  1180.   Are you a member of a BBS Network (FIDO,Hyperlink,Internet,etc)?__________                                                                  _________
  1181.  
  1182.   If so, what network and what is your BBS Address:_________________________                                                   _________________________
  1183.  
  1184.   __________________________________________________________________________  _________________________________________________________________________
  1185.  
  1186.  
  1187.   System Info: (this is to aid us in supporting you, should problems arise)
  1188.  
  1189.     CPU Type (XT/286/386/486):______________________________________________                              _____________________________________________
  1190.  
  1191.     System Speed (12Mhz,etc) :______________________________________________                              _____________________________________________
  1192.  
  1193.     Total System RAM         :______________________________________________                              _____________________________________________
  1194.  
  1195.     RAM available for Doors  :______________________________________________                              _____________________________________________
  1196.  
  1197.     Max Baud Rate (2400,etc) :______________________________________________                              _____________________________________________
  1198.  
  1199.     Do you "Lock" the baud rate higher?________ (if so, at what?)___________                                       _________                 __________
  1200.  
  1201.     Hard Disk Size (20MB,40MB) :____________________________________________                                ___________________________________________
  1202.  
  1203.     Monitor Type (Mono,CGA,etc):____________________________________________                                ___________________________________________
  1204.  
  1205.  
  1206.  
  1207.   Imperium Door Game:                                 ($20.00 US) $________
  1208.  
  1209.   One year full support & support conference access:  ($10.00 US) $________
  1210.  
  1211.                                                            Total: $________
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.                                        Index                                       _____
  1219.  
  1220.  
  1221.             Baud Rates                                                 6
  1222.             Bulletin Files                                      7, 8, 13
  1223.             Credits                                                   11
  1224.             Cycling Imperium                                           7
  1225.             Disclaimer                                                 2
  1226.             Distribution media                                         2
  1227.             EMail Addresses
  1228.               CompuServe                                              11
  1229.               FIDO Net                                                11
  1230.               RBBS Net                                                11
  1231.             Error Log File (Imp-Err.Log)                              19
  1232.             Fossils                                                    6
  1233.             Game Initialization                                        3
  1234.             ImpCycle                                                   7
  1235.             Imperium.Cfg                                           3, 13
  1236.             ImpInit                                                    3
  1237.               Command Line Options                                     4
  1238.                 /F                                                     5
  1239.                 /G                                                     4
  1240.                 /L                                                     4
  1241.                 /M                                                     4
  1242.                 /R                                                     4
  1243.                 /S                                                     4
  1244.                 /X                                                     4
  1245.                 /Y                                                     5
  1246.                 Samples                                                5
  1247.               External Map Files                                       5
  1248.               Files created                                            3
  1249.               Required files                                           3
  1250.             ImpUtil                                                    8
  1251.               Cities Functions                                         9
  1252.               Maps Functions                                           9
  1253.               Players Functions                                        9
  1254.               System Functions                                         8
  1255.               Units Functions                                          9
  1256.             IMPvvv                                                     6
  1257.             Installation                                               3
  1258.             Known Bugs & Anomalies                                    10
  1259.             Kudos                                                     12
  1260.             Map editor                                                 9
  1261.             MaxPlayers                                                 8
  1262.             Order Form                                                20
  1263.             PK information                                            13
  1264.             PK Values                                                  8
  1265.             Registration                                               2
  1266.               Key File
  1267.                 Downloading                                            2
  1268.                 File Request/Send                                      2
  1269.                 US Mail                                                2
  1270.             Running Imperium                                           6
  1271.               Batch File                                               6
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.               Command Line Parameters                                  6
  1279.               Hardware Requirements                                    6
  1280.               Local Mode                                               6
  1281.               Midnight Event                                           7
  1282.             Starting Units                                            14
  1283.             Strategic Forces                                           8
  1284.               Damage class                                             8
  1285.               Probability of dissipation/expansion                     8
  1286.               Radius of effect                                         8
  1287.             Support                                                    2
  1288.             Sysop Functions                                            7
  1289.               Chat                                                     7
  1290.               Player Eject                                             7
  1291.               Snoop (on/off)                                           7
  1292.             Sysop Utilities                                            8
  1293.             Unit Configuration
  1294.               Aircraft Carrier                                        15
  1295.               Army                                                    14
  1296.               Battleship                                              15
  1297.               Cruise Missile                                          15
  1298.               Cruiser                                                 15
  1299.               Destroyer                                               14
  1300.               Dredge                                                  16
  1301.               Engineer                                                16
  1302.               Fighter                                                 14
  1303.               Submarine                                               15
  1304.               Tank                                                    14
  1305.               Troop Transport                                         15
  1306.             Updates                                                    2
  1307.             Warhead Configuration                                     16
  1308.             Warhead Types                                             17
  1309.               Clean Fusion                                            17
  1310.               Complex Bio                                             17
  1311.               Conventional                                            17
  1312.               Dirty Fission                                           17
  1313.               Nerve Gas                                               17
  1314.               Neutron Bomb                                            17
  1315.               Simple Bio                                              17
  1316.               Toxic Waste                                             17
  1317.             Warranties                                                 2